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Abstract 

This document presents a number of quick-step instructions to get started on writing mini- 
service-oriented web services-based applications using NetBeans 6.5.x, Tomcat 6, GlassFish 2.1, 
and Java 1.6 primarily in Fedora 9 Linux with user quota restrictions. While the tutorial notes 
£^ are oriented towards the students taking the SOEN691A course on service-oriented architectures 

(SOA) at Computer Science and Software Engineering (CSE) Department, Faculty of Engineer- 
q ing and Computer Science (ENCS), other may find some of it useful as well outside of CSE or 

'— 1 Concordia. The notes are compiled mostly based on the students' needs and feedback. 
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1 Introduction 
1.1 Linux 

We are using Fedora 9 Linux during the labs. For your own work you can use any platform of 
your choice, e.g. Windows or MacOS X on your laptops. You will have to do the installation and 
configuration of NetBeans, Java, Tomcat and so on there. 

On ENCS Windows the software was not made readily available (in particular more recent 
NetBeans with the ALL option, and Tomcat 6 |Apa09] ) . 



1.1.1 Accounts 

Under UNIX, disk space (for a sample account acs691al) would be accessible under e.g. /groups/ 



a/ac_as691_al Under Windows, that path would be \\f iler-groups\groups\a\ac_soen691a_l 
("S:" drive). There is a 1GB storage space there and your in-school work related to the assignments 
and courses can be put there, as the generated data files can be large at times. 



1.1.2 Java 1.6 

Java 1.6 is not a default Java in ENCS. You need to make it default. In order to use this version 
all you need to prepend: 
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/encs/pkg/jdk-6/root/bin 

in your path. To do so there are simple instructions: 
People using tcsh: 

[sergueiOlucid ~] % setenv PATH /encs/pkg/jdk-6/root/bin: $PATH 
[sergueiOlucid ~] % rehash 
[sergueiOlucid ~] % java -version 
java version "1.6.0_14" 

Java(TM) SE Runtime Environment (build 1 . 6 . 0_14-b08) 

Java HotSpot(TM) Client VM (build 14.0-bl6, mixed mode, sharing) 

[sergueiOlucid ~] % 

People using bash: 

bash-2.05b$ export PATH=/encs/pkg/ j dk-6/root /bin : $PATH 

bash-2.05b$ rehash 

bash: rehash: command not found 

bash-2.05b$ java -version 

java version "1.6.0_14" 

Java(TM) SE Runtime Environment (build 1 . 6 . 0_14-b08) 

Java HotSpot(TM) Client VM (build 14.0~bl6, mixed mode, sharing) 

bash-2.05b$ 

You can avoid typing the above commands to set the PATH each time you open a terminal under 
Linux by recording it in ~/ . cshrcj If you do not have this file in your home directory you can 
create one with the following content (e.g. using vim [MC07J: 

set path=( /encs/pkg/jdk-6/root/bin $path ) 

or copy an example from |Mok09 and update the path to include the above directory first. Thus, 
next time when you login and open terminal, Java 1.6 will always be your default. The same applies 
if you click on the NetBeans shortcut in the menu. 

1.1.3 NetBeans 6.5.1 

NetBeans ; Suii()9l> is accessible as a simple command netbeans or from the "Applications" — ► 
"Programming" — > "NetBeans" menu with a corresponding icon. 

2 Configuring NetBeans and GlassFish for BPEL 

The ALL option typically installs GlassFish 2.1 |Sun09aJ as well as Tomcat 6 bundled by default 
with NetBeans, as well as some of the components. This includes some of the BPEL (Wik09 
components as well. To complete all the needed extensions for BPEL for GlassFish you'd need 
to download WSDL extensions and Saxon shared libraries and deploy them within your running 
GlassFish instance. Download libraries for BPEL SE |Ope09 , specifically: wsdlextlib. jar and 
saxo nlib • jar| That's all you need for your setup in the lab. For your home computer you 
may need to download and install the actual BPEL service engine component from the same web 
page |Ope09| , called bpelserviceengin e . j ar| 
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3 Step-by- Step Environment Setup 

1. Login to Linux. If you never did before likely your default Window manager is GNOME. 

2. Open up the terminal: "Applications" — * "System Tools" — * "Terminal". The window similar 
to Figure [T] should pop-up. 



File Edit View Terminal Tabs Help 



[sergueidalf redo ~] % 




Figure 1: Terminal Window 



3. Configure your Java 1.6 to be the default as outlined in Section |1.1.2| and an example is 
shown in Figure [2] 

4. In the same terminal window, change your HOME environment variable to that of your 1GB 
group directory. This will allow most portions of NetBeans to write the temporary and con- 
figuration files there by default instead of your main Unix home directory. I use a temporary 
directory of mine /tmp/groups/s/sm_s691a_l, as an example ~ and you should be using the 
directory assigned to you with your group 1GB quota. An example to do so is very similar 
as to set up PATH, except it is a single entry. It is exemplified in Figure [3] Unlike PATH, it is 
not recommended to put these commands to change your HOME into .cshrc. 



5. Create the following directories in your new HOME (your 1GB group directory): 
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Rle Edit View Terminal Tabs Help 



[serguei@alf redo ~] % setenv PATH /encs/pkg/ jdk-6/root/bin : $PATH 
[sergueidalf redo ~] % rehash 
[serguei^alf redo ~] % java -version 
java version "1.6.014" 

Java(TM) SE Rjitime Environment fojild 1.6.0 14-0Q3) 
Java HotSpot(TM) Server VM (build 14.0-bl6, mixed mode) 
[serguei@alf redo ~] % [ 



Figure 2: Setting up Java 1.6 as a Default in the Terminal 
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Rle Edit View Terminal Tabs Help 






[serguei@alf redo ~] % setenv HOME /tmp/groups/s/sm s691a 1 






[serguei@alf redo serguei] % cd 






[serguei^alf redo ~] % pwd 






/tmp/g roups/5/sm_5691a 1 






[sergueidalf redo ~] % [ 







Figure 3: Setting up HOME to the Group Directory 
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mkdir .netbeans .netbeans-derby .netbeans-registration 
Is -al 

These directories will hold all the configuration and deployment files pertaining to NetBeans, 
the Derby security controller, and the personal domain for GlassFish operation. The overall 
content may easily reach 80MB in total disk usage for all these directories. 

6. Disk usage, quota, and big files: 

quota 
du -h 
bigf iles 

7. In your real home directory, remove any previous NetBeans et co. setup files you may have 
generated from the previous runs: 

. asadminpass 

. asadmintruststore 

.netbeans* 

. personalDomain* 

(assuming no important data for you are saved there): 
\rm -rf .netbeans* .personalDomain* .asadmin* 

8. In your real home directory create symbolic links ("shortcuts") to the same NetBeans di- 
rectories, so in case it all still goes to the group directory without impending your main 
quota: 

[sergueiOalf redo "] '/, pwd 
/nf s/home/s/serguei 

[sergueiOalf redo "] '/, In -s /tmp/groups/s/sm_s691a_l/ . netbeans* . 
[sergueiOalf redo "] '/, Is -Id .netbeans* 

lrwxrwxrwx 1 serguei serguei 34 2009-07-11 08:05 .netbeans -> /tmp/groups/s/sm_s691a_l/ .netbeans 

lrwxrwxrwx 1 serguei serguei 40 2009-07-11 08:05 .netbeans-derby -> /tmp/groups/s/sm_s691a_l/ .netbeans-derby 

lrwxrwxrwx 1 serguei serguei 47 2009-07-11 08:05 .netbeans-registration -> /tmp/groups/s/sm_s691a_l/.netbeans- 

9. Again, in the same terminal window launch NetBeans, by executing command netbeans &, 
and after some time it should fully start up without of any errors. You will be prompted 
to allow Sun to collect your usage information and register; it is recommended to answer 
"No" to both. And then you will see a left-hand-side (LHS) menu, the main editor page with 
the default browsed info, and the top menu of the NetBeans, as shown in Figure |4j This is 
NetBeans 6.5.1, the latest released by the project is 6.7, and it will look slightly different in 
some places, but overall it is more-or-less the same. 

10. Navigate to the Services tab and expand the Server tree in the LHS menu. You should be 
able to see a GlassFish V2 entry there, as shown in Figure |5j 
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File Edit View Navigate Source Refactor Run Debug Profile 
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ng Tools Window Help 
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\Qc i search iCtri+li " 



BBSS 



mans ide 



Welcome to NetBeans IDE 





Java 


Java Web 


Quick Start Tutorial 


Java Web (Visual JSF> 


Web Services 




Java EE 


Java ME (MIDPj 


What's New 


Java ME (Ricoh SDK/ J) 


Java ME flJD-J) 




PHP 


Ruby 


Take a Tour 


Groovy 


C/C++ 




SOA 


NetBeans Modules 


Add any IDE plugins that you have not yet 


General Java Programming 


Swing GUIs 


installed and lookfor other features 






provided bythe NetBeans team and other 


Java Web Apps 


Java EE 


developers. 


Ruby and Rails 


Mobile A|]|is 




SOA 


UML Modeling 




PHP A|J|)S 





Add Plugins > > 



More Demos and Tutorials i 



E Show On Startup 



Output * Domain Creation Results * 



Using port 15943 for J MS . 
Using part 11967 for HOP. 
Using port 16448 for HTTP_55L. 
Using port 12087 for II0P_55L. 
Using port 12187 for IIQP_HUTUALAUTH . 
Using port 16953 for JHX_ADMIN. 
Domain being created with profile:developer, 
Security Store uses: JKS 
Domain personal Domai n created. 



as specified by variable A5_ADMIN_PR0FILE in configuration 



JB 



Figure 4: NetBeans 6.5.1 Start-up Screen 
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> & Enterprise Beans (2.x) 
v Servers 

> pj| Apache Tomcat 6,0,18 



► SS GlassFishV2 



t> Personal GlassFishV3 
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Welcome to NetBeans IDE 



Get St a 

Quick Start Tutorial 
What's New 
Take a Tour 



Add any IDE plugins that you have not yet 
installed and lookfor other features 
provided bythe NetBeans team and other 
developers. 



Add Plugins > > 



Java 

Java Web (Visual JSF) 
Java EE 

Java ME (Ricoh SDK/ J) 

PHP 

Groovy 

SOA 



General Java Programming 
Java Web Anps 
Ruby and Rails 

SOA 

PHP A|J|)S 



E Show On Startup 



Java Web 
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Java ME (MIDPj 
Java ME (BD-J) 
Ruby 
C/C++ 

NetBeans Modules 



Swing GUIs 
Java EE 
Mobile A|]|is 
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More Demos and Tutorials i 



Output 



Output * Domain Creation Results * 



Using port 15943 for J MS . 

Using part 11967 for HOP. 

Using port 16448 for HTTP_55L. 

Using port 12087 for II0P_55L. 

Using port 12187 for IIQP_HUTUALAUTH . 

Using port 16953 for JHX_ADMIN. 

Domain being created with profile:developer, 

Security Store uses: JKS 

Domain personal Domai n created. 



< 



as specified by variable A5_ADMIN_PR0FILE in configuration 



JB 



Figure 5: NetBeans: Services — ► Server — ► GlassFish V2 
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Sectors 



Servers: 
1^ Efc] Servers 




jjj Apache Tomcat 6,0,18 



Personal GlassFishV3 
WEBrick (Built-in JRuby 



< 



Add Server,.. Remove Server 



Server Name: 
Server Type: 



GlassFish V2 



GlassFish V2 



Connection 

Location: 

Username: 

Password: 



Classes 



Sources 



Javadoc 



Options 



[localhost:13115 



(admin 
[ 



Domains folder: [/home/s/serouei/.DersonalDomain 



Domain Name: [personalDomain 



□ Enable HTTP Monitor 
IZl Use IDE Proxy Settings 



Close Help 



Figure 6: Right-click GlassFish V2 —* Properties 
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11. Right-click on "GlassFish V2" and then "Properties", as in Figure [6} Observe the "Domains 
folder" and "Domain Name" . If the folder points within your normal home directory, you 
have to change it as follows: 

(a) Close the properties window. 

(b) Right-click on "GlassFish V2" and then "Remove" . Confirm with "Yes" the removal. 

(c) Right-click on "Servers" and then "Add Server...". 

(d) Select "GlassFish V2" and then "Next", and "Next". 

(e) Then for the "Domain Folder Location" Browse or paste your group directory, e.g. 
/ tmp/groups/s/ sm_s691 a_l/ . domain| in my case, notice where . domain] is an arbitrary 
name of a directory under your group directory that is not existing yet, give it any name 
you like, and then press "Next" . 

(f) Pick a user name and a password for the admin console (web-based) of GlassFish. The 
NetBeans default (of the GlassFish we removed) is 'admin' and 'adminadmin'. It is 
strongly suggested however you do NOT follow the default, and pick something else. Do 
iVOTmake it equal to your ENCS account either. 

(g) "Next" and "Finish". Keep the ports at their defaults. Notice it may take time to 
restart the new GlassFish instance and recreate your personal domain you indicated in 
the group folder. 

12. Right-click on GlassFish again and select "Start". It may also take some time to actually 
start GlassFish; watch the bottom-right corner as well as the output window for the startup 
messages and status. There should be no errors. Apache Derby network service should have 
started. 

13. Once started, right-click on GlassFish again, and select "View Admin Console". You should 
see the GlassFish login window pop-up in the Firefox web browser, looking as shown in 
Figure [7j 



14. To log in, use the username and password you created earlier in Step llf 



15. In your group home terminal, download additional libraries from |Ope09| . You will only 
need 2 (wsdlextlib. jar and saxonlib. jar) out of typical 3, because the version installed 
in ENCS already includes the 3rd (bpelserviceengine . jar). You will likely need the 3rd 
file however, for your laptop or home desktop in Windows. You can either download them 
directly from the browser, or using the wget command, as shown in Figure [8} 

16. In your GlassFish console web page, under "Common Tasks" — * "JBI" — * "Shared Libraries" 
you need to install the two libraries we downloaded (3 for your Windows laptop or home 
desktop) by clicking "Install" and following the steps by browsing to the directory where 
you downloaded the files and installing them. Then, once installed sun-saxon-library and 
sun-wsdl-ext-library should be listed under the "Shared Libraries". 

17. Make sure under "Components" you have sun-bpel-engine. Linux boxes in the labs should 
have it installed with the NetBeans, at home it's the 3rd file - bpelserviceeng ine - jar] that 
may need to be installed using the similar procedure as in the previous step. Roughly, how 
your "Components" and "Shared Libraries" should look like is in Figure [9] 
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Qmm) 



Rle Edit View History Bookmarks Tools Help 



[0 1 Mt ® I rittp://localhost:4875/login.jsf 



v |G|v Google 



e S 



Sun GLassFish'Enterprise Server v2.l 

Administration Console 



User Name: 
Password: 



Login 



Copyright © 2008 Sun Microsystems, Inc. All rights reserved. Sun Microsystems, Inc. has intellectual property rights 
relating to technology embodied in the product that is described in this document In particular, and without limitation, 
these intellectual property rights may include one or more of the U.S. patents listed at http://www.sun.com/patents and 
one or more additional patents or pending patent applications in the U.S. and in other countries. U.S. Government 
Rights - Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license 
agreement and applicable provisions of the FAR and its supplements. Use is subject to license terms. This distribution 
may include materials developed by third parties. Portions may be derived from Berkeley BSD systems, licensed from 
U. of CA. Sun, Sun Microsystems, the Sun logo, Java and GlassFish are trademarks or registered trademarks of Sun 
Microsystems, Inc. or its subsidiaries in the U.S. and other countries. 



Done 



Figure 7: GlassFish Admin Console Login Screen 
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Figure 8: Downloading Additional Libraries in a Terminal with wget 
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Figure 9: List of Components and Shared Libraries Installed in GlassFish 
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On this the environment setup should be complete. You will technically not need to repeat 
except if you remove all the files from your group directory. 



Step-by-Step Simple Application and Web Service Creation and 
Testing 

1. Go to the "Projects" tab in NetBeans. 

2. Then "File" "New Project" . 



3. Choose "Java EE" — ► "Enterprise Application", as shown in Figure 10 and then "Next". 



'O 



Steps 



1. Choose Project 

2. ... 



Choose Project 



Categories: 



□ Java 

□ Java Web 



Projects 



a 


Java ME 


□ 


PHP 


□ 


Ruby 


m 


Groovy 


a 


C/C+ + 


a 


SOA 


□ 


NetBeans Modules 




Samples 



Enterprise Application 



A Enterprise Application with Existing So 

^ EJB Module 

^ EJB Module with Existing Sources 

& Enterprise Application Client 

& Enterprise Application Client with Exist 

EH Packaged Archive 



Description: 



Creates a new enterprise application in a standard project, You can 
also create an EJB module project and Web application project in the 
enterprise application. A standard project uses an IDE-generated Ant 
build script to build and run your projects, 



< Back 




Next > 




Finish 




Cancel 




Help 



Figure 10: "Java EE" — ► "Enterprise Application 1 



4. Give the project properties, like Project Name to be "Al", project location somewhere in 
your group directory, e.g. as for me shown in Figure fTTJ and then "Next" . 



5. In the next tab, you can optionally enable "Application Client Module" for an example, and 



keep the rest at their defaults, e.g. as shown in Figure 12 Notice, I altered the client package 
Main class to be in soen691a. al .Main. It is not strictly required in here as you can test your 
web services using web service unit testing tools built-into the IDE. 
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o 



Steps 



1. Choose Project 

2. Name and Location 

3. Server and Settings 



Name and Location 



Project Name: 



Al 



Project Location: /tmp/groups/s/sm_s691a_l/NetBeansProjects 
Project Folder: mp/groups/s/srn_s691a_l/NetBeansProjects/Al 



□ Use Dedicated Folder for Storing Libraries 

Libraries Folder: 



Different users and projects can share the 
same compilation libraries [see Help for details), 



Browse. 



Browse. 



Set as Main Project 



< Back 




Next > 




Finish 




Cancel 




Help 



Figure 11: NetBeans Programming Projects Location 
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Steps 



1. Choose Project 

2. Name and Location 

3. Server and Settings 



Server and Settings 



Server: 



GlassFish V2 



Add.. 



□ Use dedicated library folder for server JAR files 



java EE Version: |Java EE 5 



Create EJB Module: 



Al-ejb 



Create Web Application Module: Al-war 



Create Application Client Module: Al-app-client 



Main Class: soen691a,[al.Main 




< Back Next > | Finish Cancel Help 



Figure 12: Al's Example Server and Client Settings 
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6. Click "Finish" to create your first project with the above settings. You should see something 



that looks like as shown in Figure 13 after some of the tree elements expanded. 



7. Under Al-war, create a package, called soen691a by right-clicking under "Al" — > "Source 
Packages" -> "New" -> "Java Package" -» "Package Name": soen691a. Then "Finish". 

8. Create a "Web Service" under that package, by right-click on the newly created package — * 



"New" — > "Web Service" — ► "Web Service Name" — > Login, as shown in Figure 14 



9. The LHS project tree if expanded would look like shown in Figure 14 



10. Right-click on Login WS, and select "Add Operation..." and create a web method loginQ, 



as shown in Figure 16 



11. After the web method login appears as a stub inside the Login class with return false; 
by default. For quick unit testing of the new method, implement it with some test user name 



and password as shown in Figure 17 which will later be replaced to be read from the XML 
file. 

12. Perform a simple unit test for the web method. Your GlassFish must be running and you 
have to "start" your project by deploying - just press the green angle "play" button. You 
should see a "Hello World" page appearing in your browser. 

13. Then, under "Al-war" — * "Web Services" — > "Login" right-click on Login and select "Test 
Web Service" . It should pop- up another browser window (or tab) titled something like "Lo- 
ginService Web Service Tester" with a pre-made form to test inputs to your web method(s), 



as shown in Figure 18 



14. Fill-in the correct test values that we defined earlier for login and press the "login" button. 
Observe the exchanged SOAP XML messages and the true value returned as a result, as 



shown in Figure 19 



Then try any wrong combination of the username and password and see that it returns false. 
This completes basic verification of your web service - that is can be successfully deployed 
and ran, and its method(s) unit-tested on the page. 

15. Java-based client callee of a web service has to be defined e.g. as a WS client, as shown in 
earlier screenshots as "Al-app-client" , which has a Main. main () method. In that method you 
simply invoke the desired service by calling its web method after a number of instantiations. 
It may look like you are calling a local method of a local class, but, in fact, on the background 
there is a SOAP message exchange, marshaling/demarshaling of data types, etc. and actually 
connection to a web service, posting a request, receiving and parsing HTTP response, etc. 
all done by the middleware. 

Steps: 

(a) Right-click "Al-app-client" — >■ "New" — > "Web Service Client". A dialog shown in 



Figure 20 should appear. Click "Browse" 



(b) Select your web service to generate a reference client for, as e.g. shown in Figure 21 and 
click "OK". 
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c 



Steps 



1. Choose File Type 

2. Name and Location 



Name and Location 



Web Service Name: 



Login| 



Project: Al-war 



Location: Source Packages 
Package: soen691a 







® Create Web Service from Scratch 

O Create Web Service from Existing Session Bean 

Enterprise Bean: 



Browse. 



< Back Next ; 



Finish Cancel 



Help 



Figure 14: New Login Web Service 
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Name: login 



Return Type: boolean 



Parameters Exceptions 



Browse, 




OK Cancel 



Figure 16: Adding a Web Method login () 



(c) Having selected the service to generate the WS client code for, you should see the URL, 



as shown in Figure 22 "Finish", re-deploy (green "Play" button). 

(d) Then, in Main, import the generated code classes to invoke the service, as shown in 
Listing [T] 

See also an example from DMARF |Mok06 . 

16. Relative path for loading XML can be found using System. getProperty ( ' 'user. dir' ') 
to find out your current working directory of the application, which is actually relative to 



the config/ subdirectory in your personal domain folder, so it would be based on your 
deployment, but roughly: 



System. getPropertyC'user. dir") + "../generated/ /users. xml' 



where " " is the path leading to where your users . xml and others actually are. You can 



configure Ant's build. xml (actually build- impl .xml and other related files for deployment 
to copy your XML data files into config/ automatically. 



17. Loading and querying XML with SAX is exemplified in TestNN with MARF |CMt09t IThe09] . 
specifically at these CVS URLs: 

http : / /marf . cvs . sf .net/viewvc/marf /apps/TestNN/ 



http : / /marf . cvs . sf .net/viewvc/marf /marf /src/marf /Class if ication/NeuralNetwork/ 
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Figure 17: Implementing a Simple Web login () Method for Quick Unit Testing 
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package socn691a.al; 

import soen691a . Login ; 
import soen691a . LoginService ; 



* ©author serguei 

*/ 

public class Main { 

/* * 

* (Sparam args the command line arguments 

*/ 

public static void main ( St ring [ ] args) { 

LoginService service = new LoginService () ; 
Login login = service . getLoginPort () ; 

//... 

// Must be false 

boolean success = login . login (" wrongusername" , " wrongpasword" ) ; 
// Must be false 

success = login . login (" wrongusername" , " pa$$+3$T" ) ; 
// Must be false 

success = login . login (" userTest " , "wrongpasword"); 
// Must be true 

success = login . login (" userTest" , " pa$$+3$T" ) ; 
//... 



Listing 1: Invoking a Web Service from a Plain Java Class 
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Rle Edit View History Bookmarks Tools Help 



^ v 8 A ® http://localhost:8107/Al-war/l_oginService?Tester v |G]v .ogle ^ 



LoginService Web Service Tester 

This form will allow you to test your web service implementation f WSDL File ) 

To invoke an operation, fill the method parameter(s) input boxes and click on the 
button labeled with the method name. 

Methods : 

public abstract boolean soen69la.Login.login(java.lang.String,java.lang. String) 

[ login | ( [userTest j , fpa$$+3$T | ) 



Done 



Figure 18: Unit-testing Page for the Login WS 

Do not validate your XML unless you specified a DTD schema (not necessary here), just 
make sure your tags are matching, properly nested, and closed. 



5 BPEL Composite Applications 

GlassFish is needed for BPEL (while the previous could be done with Tomcat 6). E.g. tutorial 
from Net Beans: 

http: //www.netbeans . org/kb/61/soa/loanprocessing.html 

Similarly, there are good application samples available in the betbeans to start the process of 
a BPEL composite application: "New" — > "Samples" — > "SOA"; specifically "Travel Resevation 
Service" and "BPEL BluePrint 1". 



6 Conclusion 

Please direct any problems and errors with these notes or any other constructive feedback to 
mokhovOcse . concordia. ca, 

6.1 See Also 

• GlassFish website [S un09a| . 

• Unix commands |Mok05]. 
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File Edit View History Bookmarks Tools Help 



^ [©) ; http://localhost:81D7/Al-war/LoginS! v [G]v|Google 



login Method invocation 



Method parameter(s) 



Type 



Value 



java.lang. String userTest 



java.lang. String pa$$+3$T 



Method returned 



boolean : "true" 



SOAP Request 



<?xml version=" 1. 0" encoding="UTF-8"?> 

<S : Envelope xmlns : S="http : //schemas . xmlsoap . org/soap/envelope/"> 
<S : Header/> 
<S : Body> 

<ns2 : login xmlns : ns2="http : //soen691a/"> 
<username>userTest</usernaine> 
<passwo rd>pa$$+3$T</passwo rd> 
</ns2 : login> 
</S : Body> 
</S : Envelope> 



SOAP Response 



<?xml version=" 1. 0" encoding="UTF-8"?> 

<S : Envelope xmlns : S="http : //schemas . xmlsoap . org/soap/envelope/"> 
<S : Body> 

<ns2 : loginResponse xmlns : ns2="http : //soen691a/"> 

< retu rn >t ru e</ retu rn > 
</ns2 : loginResponse* 
</S:Body> 
</S : Envelope> 



Done 



Figure 19: login () Well Method Invocation Trace 
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Steps 



WSDL and Client Location 



1, Choose File Type 

2. WSDL and Client 
Location 



Specify the WSDL file of the Web Service, 
® Proiect: [ 
O Local File: 
O WSDL URL: f 



Browse.., 



Browse. 



Set Proxy., 



Specify a location for the client, 



Project: Al-app-client 



Package: <default package> 



Client Style: JAX-WS Style 



□ Generate Dispatch code 

Q Enter the URL of the service you wish to use, 



< Back 




Next > 




Finish 




Cancel 




Help 



Figure 20: Creating a New Web Services Client in the Client Application Package from a Project 



Web Services: 
■w ^ Al-war 



E Login 



OK Cancel 



Figure 21: Selecting the Service to Create a Client For from the Project 
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Steps 



1, Choose File Type 

2. WSDL and Client 
Location 



WSDL and Client Location 



Specify the WSDL file of the Web Service, 



(§) Project: [ http://localhost: 81 07/A1 -war/Log inService?wsdl 
O Local File: 
O WSDL URL: 



Browse., 



Browse.., 



Set Proxy., 



Specify a location for the client, 
Project: [Al-app-client 
Package: 



<default package> 



Client Style: JAX-WS Style 




□ Generate Dispatch code 



< Back Next > Finish Cancel Help 



Figure 22: Creating a New Web Services Client Nearly Done. Notice the URL 



ENCS help: http : //www . encs . concordia . ca/helpdesk/ 



An example of the XML parsing application, TestNN with MARF [CMt09 ; The09] using the 
built-in SAX parser. 
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